home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / pm.z / pm
Encoding:
Text File  |  2002-10-03  |  13.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ppppmmmm((((3333))))                                                                    ppppmmmm((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      pm_create, pm_create_simple, pm_filldefault, pm_destroy, pm_attach,
  10.      pm_setdefault, pm_getdefault, pm_getall, pm_getstat, pm_setpagesize -
  11.      Policy Module operations
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ppppmmmmoooo....hhhh>>>>
  16.  
  17.      ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt ppppmmmm____ccccrrrreeeeaaaatttteeee((((ppppoooolllliiiiccccyyyy____sssseeeetttt____tttt**** ppppoooolllliiiiccccyyyy____sssseeeetttt))))
  18.  
  19.      ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt
  20.      ppppmmmm____ccccrrrreeeeaaaatttteeee____ssssiiiimmmmpppplllleeee((((cccchhhhaaaarrrr**** ppppllllaaaacccc____nnnnaaaammmmeeee,,,,
  21.                       vvvvooooiiiidddd**** ppppllllaaaacccc____aaaarrrrggggssss,,,,
  22.                       cccchhhhaaaarrrr**** rrrreeeeppppllll____nnnnaaaammmmeeee,,,,
  23.                       vvvvooooiiiidddd**** rrrreeeeppppllll____aaaarrrrggggssss,,,,
  24.                       ssssiiiizzzzeeee____tttt ppppaaaaggggeeee____ssssiiiizzzzeeee))))
  25.  
  26.  
  27.      vvvvooooiiiidddd ppppmmmm____ffffiiiillllllllddddeeeeffffaaaauuuulllltttt((((ppppoooolllliiiiccccyyyy____sssseeeetttt____tttt**** ppppoooolllliiiiccccyyyy____sssseeeetttt))))
  28.  
  29.      iiiinnnntttt ppppmmmm____ddddeeeessssttttrrrrooooyyyy((((ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt ppppmmmm____hhhhaaaannnnddddlllleeee))))
  30.  
  31.      iiiinnnntttt ppppmmmm____aaaattttttttaaaacccchhhh((((ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt ppppmmmm____hhhhaaaannnnddddlllleeee,,,, vvvvooooiiiidddd**** bbbbaaaasssseeee____aaaaddddddddrrrr,,,, ssssiiiizzzzeeee____tttt lllleeeennnnggggtttthhhh))))
  32.  
  33.      ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt ppppmmmm____sssseeeettttddddeeeeffffaaaauuuulllltttt((((ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt ppppmmmm____hhhhaaaannnnddddlllleeee,,,,
  34.                                 mmmmeeeemmmm____ttttyyyyppppeeee____tttt mmmmeeeemmmm____ttttyyyyppppeeee))))
  35.  
  36.      ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt ppppmmmm____ggggeeeettttddddeeeeffffaaaauuuulllltttt((((mmmmeeeemmmm____ttttyyyyppppeeee____tttt mmmmeeeemmmm____ttttyyyyppppeeee))))
  37.  
  38.      iiiinnnntttt ppppmmmm____ggggeeeettttaaaallllllll((((vvvvooooiiiidddd**** bbbbaaaasssseeee____aaaaddddddddrrrr,,,, ssssiiiizzzzeeee____tttt lllleeeennnnggggtttthhhh,,,,
  39.                    ppppmmmmoooo____hhhhaaaannnnddddlllleeee____lllliiiisssstttt____tttt**** ppppmmmmoooo____hhhhaaaannnnddddlllleeee____lllliiiisssstttt))))
  40.  
  41.      iiiinnnntttt ppppmmmm____ggggeeeettttssssttttaaaatttt((((ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt ppppmmmm____hhhhaaaannnnddddlllleeee,,,, ppppmmmm____ssssttttaaaatttt____tttt**** ppppmmmm____ssssttttaaaatttt))))
  42.  
  43.      iiiinnnntttt ppppmmmm____sssseeeettttppppaaaaggggeeeessssiiiizzzzeeee((((ppppmmmmoooo____hhhhaaaannnnddddlllleeee____tttt ppppmmmm____hhhhaaaannnnddddlllleeee,,,, ssssiiiizzzzeeee____tttt ppppaaaaggggeeee____ssssiiiizzzzeeee))))
  44.  
  45.  
  46. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  47.      _pppp_mmmm______cccc_rrrr_eeee_aaaa_tttt_eeee creates a policy module.
  48.  
  49.      _pppp_mmmm______cccc_rrrr_eeee_aaaa_tttt_eeee______ssss_iiii_mmmm_pppp_llll_eeee creates a policy module with some predefined defaults.
  50.  
  51.      _pppp_mmmm______ffff_iiii_llll_llll_dddd_eeee_ffff_aaaa_uuuu_llll_tttt fills a policy_set with predefined default values.
  52.  
  53.      _pppp_mmmm______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy destroys a policy module.
  54.  
  55.      _pppp_mmmm______aaaa_tttt_tttt_aaaa_cccc_hhhh connects a policy module to a virtual address space range.
  56.  
  57.      _pppp_mmmm______ssss_eeee_tttt_dddd_eeee_ffff_aaaa_uuuu_llll_tttt sets the default policy modules for a process' address
  58.      space.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppmmmm((((3333))))                                                                    ppppmmmm((((3333))))
  71.  
  72.  
  73.  
  74.      _pppp_mmmm______gggg_eeee_tttt_dddd_eeee_ffff_aaaa_uuuu_llll_tttt retrieves the current default policy modules associated
  75.      with a process' address space.
  76.  
  77.      _pppp_mmmm______gggg_eeee_tttt_aaaa_llll_llll retrieves all the policy modules associated with an address
  78.      space range.
  79.  
  80.      _pppp_mmmm______gggg_eeee_tttt_ssss_tttt_aaaa_tttt retrieves the current state of a policy module (policies and
  81.      parameters for a specific policy module).
  82.  
  83.      _pppp_mmmm______ssss_eeee_tttt_pppp_aaaa_gggg_eeee_ssss_iiii_zzzz_eeee sets and synchronizes the page size for a policy module.
  84.  
  85.      _pppp_mmmm______cccc_rrrr_eeee_aaaa_tttt_eeee and _pppp_mmmm______cccc_rrrr_eeee_aaaa_tttt_eeee______ssss_iiii_mmmm_pppp_llll_eeee will fail and a policy module will not be
  86.      created if one or more of the following are true:
  87.  
  88.      _EEEE_BBBB_UUUU_SSSS_YYYY          The policy module structures were temporarily in use by
  89.                     another thread.
  90.  
  91.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT         Arguments could not be copied into kernel space.
  92.  
  93.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         One or more of the specified policy settings are invalid.
  94.  
  95.      _pppp_mmmm______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy will fail and the policy module will not be destroyed if the
  96.      following is true:
  97.  
  98.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified _pppp_mmmm______hhhh_aaaa_nnnn_dddd_llll_eeee is invalid or does not exist.
  99.  
  100.      _pppp_mmmm______aaaa_tttt_tttt_aaaa_cccc_hhhh will fail and no policy module will be attached to a virtual
  101.      address space range if one or more of the following is true:
  102.  
  103.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT         Arguments could not be copied into kernel space.
  104.  
  105.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified _pppp_mmmm______hhhh_aaaa_nnnn_dddd_llll_eeee is invalid or does not exist.
  106.  
  107.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The summation of the specified _bbbb_aaaa_ssss_eeee______aaaa_dddd_dddd_rrrr plus the _llll_eeee_nnnn_gggg_tttt_hhhh
  108.                     are less than the specified _bbbb_aaaa_ssss_eeee______aaaa_dddd_dddd_rrrr. This condition can
  109.                     occur if the _bbbb_aaaa_ssss_eeee______aaaa_dddd_dddd_rrrr plus _llll_eeee_nnnn_gggg_tttt_hhhh wrap around the upper
  110.                     limit of the virtual address range.
  111.  
  112.      _pppp_mmmm______ssss_eeee_tttt_dddd_eeee_ffff_aaaa_uuuu_llll_tttt will fail and the default policy modules will not be set if
  113.      the following is true:
  114.  
  115.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified memory type is invalid.
  116.  
  117.      _pppp_mmmm______gggg_eeee_tttt_dddd_eeee_ffff_aaaa_uuuu_llll_tttt will fail and no values will be returned if one or more of
  118.      the following are true:
  119.  
  120.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified memory type is invalid.
  121.  
  122.      _pppp_mmmm______gggg_eeee_tttt_aaaa_llll_llll will fail and no values will be returned if one or more of the
  123.      following are true:
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ppppmmmm((((3333))))                                                                    ppppmmmm((((3333))))
  137.  
  138.  
  139.  
  140.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT         Arguments could not be copied into or out of kernel space.
  141.  
  142.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified list length is less than 1.
  143.  
  144.      _EEEE_2222_BBBB_IIII_GGGG          The specified list length is greater than the maximum
  145.                     supported length.
  146.  
  147.      _pppp_mmmm______gggg_eeee_tttt_ssss_tttt_aaaa_tttt will fail and the policy module state will not be retrieved if
  148.      one or more of the following are true:
  149.  
  150.      _EEEE_FFFF_AAAA_UUUU_LLLL_TTTT         Data could not be copied out of kernel space.
  151.  
  152.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified _pppp_mmmm______hhhh_aaaa_nnnn_dddd_llll_eeee is invalid or does not exist.
  153.  
  154.      _pppp_mmmm______ssss_eeee_tttt_pppp_aaaa_gggg_eeee_ssss_iiii_zzzz_eeee will fail and the policy module page size will be
  155.      unaffected if one or more of the following is true:
  156.  
  157.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified _pppp_mmmm______hhhh_aaaa_nnnn_dddd_llll_eeee is invalid or does not exist.
  158.  
  159.      _EEEE_IIII_NNNN_VVVV_AAAA_LLLL         The specified page size is invalid.
  160.  
  161. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  162.      numa(5), mmci(5), mldset(3c), mld(3c), migration(3c), pminfo(3c).
  163.  
  164. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  165.      Upon successful completion, _pppp_mmmm______cccc_rrrr_eeee_aaaa_tttt_eeee and _pppp_mmmm______cccc_rrrr_eeee_aaaa_tttt_eeee______ssss_iiii_mmmm_pppp_llll_eeee return a value
  166.      of type pmo_handle_t that represents the created policy module,
  167.      _pppp_mmmm______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy and _pppp_mmmm______aaaa_tttt_tttt_aaaa_cccc_hhhh, _pppp_mmmm______gggg_eeee_tttt_dddd_eeee_ffff_aaaa_uuuu_llll_tttt, _pppp_mmmm______ssss_eeee_tttt_dddd_eeee_ffff_aaaa_uuuu_llll_tttt, _pppp_mmmm______gggg_eeee_tttt_aaaa_llll_llll,
  168.      _pppp_mmmm______gggg_eeee_tttt_ssss_tttt_aaaa_tttt and _pppp_mmmm______ssss_eeee_tttt_pppp_aaaa_gggg_eeee_ssss_iiii_zzzz_eeee return 0.  Otherwise, a value of -1 is
  169.      returned and _e_r_r_n_o is set to indicate the error.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.